Установка видимости заголовочного файла

Управляйте видимостью заголовочного файла путем указания его цели или роли, в его цели.

bullet
Установить видимость для заголовочного файла
  1. В редакторе проекта выберите цель, содержащую заголовочный файл, видимость которого Вы хотите установить.

  2. Нажмите Build Phases наверху редактора проекта.

  3. Выберите Editor> Add Build Phase> Add Copy Headers Build Phase.

  4. Раскройте раздел Copy Headers в области Build Phases редактора проекта.

  5. Нажмите кнопку Add (+) у основания раздела.

  6. Выберите заголовочный файл, Вы хотите добавить, и нажать Add.

  7. Перетащите заголовочный файл к категории (Общедоступный, Частный, или Проект) надлежащий его доступности в продукте.

    ../Art/copy_headers_configuration_2x.png

При определении цели можно реализовать символы, которые Вы хотите обнародовать клиентам продукта цели. Но сделать Ваш продукт простым в использовании (и сохранить подробные данные реализации скрытыми), можно хотеть сохранить многие ее символы недоступными клиентам продукта.

Используйте эти критерии для установки надлежащей видимости заголовочного файла:

  • Общественность: интерфейс завершен и предназначен, чтобы использоваться клиентами Вашего продукта. Общедоступный заголовок включен в продукт как читаемый исходный код без ограничения.

  • Частный: интерфейс не предназначается для Ваших клиентов, или это находится на ранних стадиях разработки. Частный заголовок включен в продукт, но это отмечено «частное». Таким образом символы видимы всем клиентам, но клиенты должны понять, что они, как предполагается, не используют их.

  • Проект: интерфейс для использования только файлами реализации в текущем проекте. Заголовок проекта не включен в цель, кроме объектного кода. Символы не видимы клиентам вообще, только Вам.

Продуктами сборки, к которым применяются эти различия, являются библиотеки, платформы или приложения, принимающие плагины, и это поэтому должно предоставить общедоступные заголовочные файлы клиентам.